home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / ohlutil.zip / README < prev    next >
Text File  |  1990-06-22  |  4KB  |  82 lines

  1. This is the GNU file manipulation utilities package.  Most of these
  2. programs have significant advantages over their Unix counterparts,
  3. such as greater speed or additional flexibility.
  4.  
  5. Changes from release 1.0 include some bug fixes, enhancements, and
  6. changes for POSIX conformance, including the addition of two programs
  7. invented by the POSIX committee.  Changes from release 1.1 are an
  8. important bug fix for cp on systems that do not have the ftruncate
  9. system call.  Changes from release 1.2 are the addition of a program
  10. to print files backwards and a program to install files, more bug
  11. fixes and POSIX and ANSI C changes, support for 16 bit machines, and
  12. backup file creation options.
  13.  
  14. The fileutils are intended to be POSIX compliant (with BSD and other
  15. extensions), like the rest of the GNU system.  They are not all quite
  16. there yet; however, the POSIX shell and utilities standard (1003.2)
  17. has not been finalized, either.  They presently don't support
  18. internationalization features, since none of the C libraries that I
  19. have access to do.  (The GNU C library will, but isn't finished.)
  20.  
  21. The documentation for these programs is not finished yet, and needs to
  22. be rewritten.  However, most of them accept descriptive long-named
  23. options in addition to Unix-style short-named options, which should
  24. help you figure out their additional features.  Giving a `-h' option
  25. (or any invalid option) will produce a usage message.  Some of the
  26. programs also have explanatory comments at the top of the source code.
  27.  
  28. The ls, dir, and vdir commands are all separate executables instead of
  29. one program that checks argv[0] because people often rename these
  30. programs to things like gls, gnuls, l, etc., and renaming a program
  31. file shouldn't affect how it operates, so that people can get the
  32. behavior they want with whatever name they want.
  33.  
  34. The GNU ls with the -s option, and at the top of long listings of
  35. directories, reports file sizes in units of 512 bytes by default, as
  36. required by POSIX.  The GNU du does the same thing, for consistency.
  37. The GNU ls and du both have a -k option to make them report sizes in
  38. kilobytes instead.
  39.  
  40. The GNU tail command has no -r option (print backwards).  Reversing a
  41. file is really a different job from printing the end of a file; the
  42. BSD tail can get away with kludging it in because of its limited size
  43. buffer.  A more versatile way than tail -r to reverse files is the
  44. `tac' command included in this package.
  45.  
  46. The GNU rm, like every other program that uses getopt, lets you use the
  47. "--" option to indicate that all following arguments are non-options.
  48. To remove a file called "-f", you could either
  49.     rm -- -f
  50. or
  51.     rm ./-f
  52. The Unix rm's use of "-" for this purpose predates the development of
  53. the getopt standard syntax.
  54.  
  55. The GNU cp, mv, and ln commands can now make backups of files that
  56. they are about to overwrite or remove.  They make backups only when
  57. the -b (+backup) option is given.
  58.  
  59. The type of backups made can be set with the VERSION_CONTROL
  60. environment variable, which can be overridden by the -V
  61. (+version-control) option.  If VERSION_CONTROL is not set and -V
  62. (+version-control) is not given, the default backup type is
  63. `existing'.
  64.  
  65. The value of VERSION_CONTROL and the argument to -V (+version-control)
  66. is like GNU Emacs' `version-control' variable; it also accepts
  67. synonyms that are more descriptive.  The valid values are (unique
  68. abbreviations are accepted):
  69.  
  70. t or numbered        Always make numbered backups.
  71. nil or existing        Make numbered backups of files that already
  72.             have them, simple backups of the others.
  73. never or simple        Always make simple backups.
  74.  
  75. The suffix used for making simple backup files can be set with the
  76. SIMPLE_BACKUP_SUFFIX environment variable, which can be overridden by
  77. the -S (+suffix) option.  If neither of those is given, the default is
  78. `~', as it is in Emacs.
  79.  
  80. Suggestions and bug reports for these programs should be mailed to
  81. bug-gnu-utils@prep.ai.mit.edu.
  82.